Sie befinden sich hier: Software > DOS > CSV > CSV to HTM > Doku    

Dokumentation von CSV-HTM

Version: 1.38

2007 July 20


VORWORT
-------

Vorneweg: CSV-HTM ist Freeware. Die Benutzung geschieht auf
eigene Gefahr. Aus rechtlichen Gruenden garantiere ich fuer nichts.
Eine Aenderung des Sourcecodes und des Programmes sind nicht erlaubt.

CSV-HTM steht fuer CSV HTML.
Das Programm setzt eine (z.B. aus Excel exportierte) CSV Tabelle mittels einer
Steuerdatei in eine HTML Tabelle um. Die Umsetzung erfolgt aber nicht 1:1
wie bei meinem Programm CSVTable, sondern zeilwenweise werden Informationen
extrahiert. Dabei koennen beliebige Texte mit erzeugt werden.

Die 1. Spalte
wird linksbuendig, die anderen Spalten rechtsbuendig angeordnet.

Warum unter DOS?
Nun, ich programmiere in QBasic gerne einen schnellen Hack,
der sich dann auch mal ausweiten kann. Ausserdem benutze ich gerne
Batches, um meine Daten zu verarbeiten. Da bieten sich DOS-Utilities
eben an.


INSTALLATION
------------

Entpacken Sie alle Dateien in ein Verzeichnis Ihrer Wahl.


BENUTZUNG
---------

Sie kopieren das Programm entweder in das Verzeichnis mit den HTML-Dateien
oder kopieren das Programm in den Command-Ordner, damit DOS das Programm
auch findet.

Das Programm arbeitet im wesentlichen mit einer Steuerdatei (Uebergabe
via Kommandozeile siehe unten).

Die CSV-Tabelle wird anhand der ersten Zeile mit den Spaltennamen der ersten
Zeile bearbeitet. Nur die ersten Spalten werden in spaeteren Zeilen benutzt.

Alle Zelleintraege werden von Apostrophen befreit (am Anfang und Ende).

Diese Datei wird als CSV-HTM.INP als Beispiel beigelegt und muss auch
immer diesen Namen tragen.

Alle Zeilen, die ein ' am Anfang tragen werden ignoriert.
Die anderen Zeilen heissen bei mir "wertige Zeilen".

Die erste wertige Zeile enthaelt den Namen der CSV-Datei.

Die zweite wertige Zeile enthaelt das Trennzeichen (muss druckbar sein, also
kein Tabulator).

Die dritte wertige Zeile enthaelt die Form "Text = Bedingung",
"Text == Bedingung" oder "Text === Bedingung".
Dabei steht "=" fuer enthalten, "==" fuer ungleich und
"===" fuer gleich.
Ist nur "Text" ohne "=", "==" oder "===" enthalten,
so wird jede Zeile der CSV Datei verarbeitet, wenn die Spalte der
Bedingung ungleich Leerzeichen ist.

Ist eine Bedingung angegeben, so werden nur Zeilen bearbeitet,
deren Spaltenname "Text" gleich bzw. ungleich der "Bedingung" ist.

Steht am Ende dieser wertigen Zeile " # Datei = Kommando",
so wird jede Zeile in eine einzelne Datei ausgegeben, wobei Kommando
ein Steuerkommando wie im naechsten Abschnitt beschrieben, darstellt.

Alle folgenden wertigen Zeilen sind Steuerkommandos!

Diese sind grundsaetzlich so aufgebaut, dass das "+" Zeichen als Verbinder
dient, d.h. es hat die Form A+B+C+D+E+F..., wobei + nicht am Ende
oder Anfang stehen darf. Die Zeichenketten A,B,C,... enthalten entweder
einen Spaltennamen oder nicht. Ist es ein Spaltenname der CSV-Datei, so
wird der Inhalt der aktuellen Zeile in der Spalte benutzt, ansonsten wird
die Zeichenkette ausgegeben. Achtung: Auch Blanks, Satzzeichen etc. sind
Zeichenketten.

Wenn Sie eine Zeile der Form (Leerzeichen beachten!) "Text1 = A+B+C etc."
als Kommando waehlen, so wird die Zeile nur ausgegeben, wenn alle Zeichen
ketten A,B,C auch wirklich existieren.

Will man Fuellzeilen ausgeben, die in jedem Fall auszugeben sind, so
muss man diese Zeilen mit einem "# " beginnen. Allerdings duerfen
in der Zeile keine " = " Kommandos und +...+ Kommandos enthalten
sein.

Sollen diese Zeichen mit ausgegeben werden, muss man ein
"## " am Anfang einer Zeile schreiben!

Soll eine Zeile nur ausgegeben werden, wenn ein gewisser Wert erfuellt ist,
so setzt man vor die Zeile ein {Code=Wert}Zeile.
Nun wird 'Zeile' nur ausgegeben, wenn die Spalte 'Code' den Wert 'Wert' hat.
Gibt man statt einem '=' zwei '==' ein, so wird die Zeile nur bei
Ungleichheit ausgegeben. Im Gegensatz zur obigen allgemeinen Bedingung bedeutet
hier ein "===", dass der Wert im Code nur enthalten ist.

Nun probieren Sie einfach herum.

Die Ausgabe ist sehr maechtig.

Als Ergebnis wird eine Datei CSV-HTM.HT erzeugt, die den HTML-Code
erzeugt. Dieser kann somit manuell oder automatisiert weiter
verarbeitet werden.

Das Programm legt die Hilfsdateien CSV-HTM.DAT, CSV-HTM.SPA und CSV-HTM.WAS
und CSV-HTM.MEN und CSV-HTM.FTP an,
die nicht geloescht werden.
Somit kann man diese Dateien bei Bedarf seperat weiterverwenden.

In der Datei CSV-HTM.ANZ steht die Anzahl der ausgegebenen Faelle als Zahl.

Es gibt automatische Korrekturen, die auch Leereintraege korrigieren.

Ausgaben wie ", , " werden zu ", " korrigiert, ", <" zu "<",
Leerreferenzen a href="[http:]]"..Text zu "Text", Leerspalten bei Tabellen
td...td mit   aufgefuellt.



PARAMETER
---------

Zur Zeit werden folgender Parameter unterstuetzt:

lim   - Trennzeichen in den Daten wird beruecksichtigz.
nolim - Trennzeichen in den Daten wird als Trenner genutzt (Standard).
log   - Es wird ein Logfile CSV-HTM.LOG angelegt.
nolog - Es wird kein Logfile angelegt (Standard).
lr    - Leere Eintraege werden ausgegeben (bei Tabellen wichtig).
nolr  - Leere Eintraege werden nicht ausgegeben (bei Fliesstext OK).
nobr  - Nach jedem extrahierten Zeileneintrag folgt KEIN extra Zeilenumbruch.
br    - Nach jedem extrahierten Zeileneintrag folgt EIN extra Zeilenumbruch.
nohr  - Nach jedem extrahierten Zeileneintrag folgt KEINE horizontale Linie.
hr    - Nach jedem extrahierten Zeileneintrag folgt EINE horizontale Linie.
ascii - Nach jedem extrahierten Zeileneintrag folgt ein ASCII Zeilenumbruch.
html  - Nach jedem extrahierten Zeileneintrag folgt ein einziges br (Standard).

WEBSEITE
--------

Die Software liegt unter http://www.jostjahn.de/software/csv-htm.zip
Diese Datei liegt unter http://www.jostjahn.de/software/csv-ht.html

Sollten diese beiden Webseiten nicht erreichbar sein, schauen
Sie im Index von http://www.jostjahn.de nach.

Unter http://www.jostjahn.de/software/softnews.html koennen Sie sich
auch in einen Newsletter eintragen lassen, der Ihnen Updates mitteilt.


KONTAKT
-------

Verbesserungsvorschlaege und Fehlermeldungen senden Sie bitte
an webmaster@jostjahn.de